home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / cpp112.zoo / cpp.man < prev    next >
Text File  |  1994-07-07  |  13KB  |  331 lines
  1.  
  2.  
  3. CPP (1)                       30 May 1993                        CPP (1)
  4.  
  5.  
  6.  
  7.  
  8. pNAMEq pq pq pq pq pq pq pq pq 
  9.         cpp - a stand-alone C preprocessor 
  10.  
  11. pSYNOPSISq pq pq pq pq pq pq pq pq 
  12.         pcppq [ p-CTVq ] [ p-Pq[012]pqpq ] [ p-Dqnamepqpq ] 
  13.              [ p-Dqnamep=qdefpq ] [ p-Iqdirectorypqpq ] [ p-Uqnamepqpq ] 
  14.              [ p-ansiq ] [ p-fq[no-]pc++-commentsqpq ] [ p-Wq[no-]pbad-charsqpq ] 
  15.              [  p-Wq[no-]pnested-commentsqpq  ] [ p-Wq[no-]pbad-concat-tokensqpq ] [
  16.         pinput-fileq [ poutput-fileq ] ] 
  17.  
  18. pDESCRIPTIONq pq pq pq pq pq pq pq pq 
  19.  
  20.         pcppq is a stand-alone C preprocessor, intended  for  use  with  C
  21.         compilers   such   as  HSC  which  do  not  provided  access  to
  22.         preprocessor output.  It implements as closely  as  possible  an
  23.         ANSI standard C preprocessor, including trigraphs, token pasting 
  24.         and stringizing.  
  25.  
  26.         pcppq optionally  accepts  two filenames as arguments.  pinput-fileq
  27.         and poutput-fileq are, respectively, the input  and  output  files
  28.         for the  preprocessor.    If  not specified, or if given as `-',
  29.         they default to the standard  input  and  the  standard  output,
  30.         respectively.  
  31.  
  32. pOPTIONSq pq pq pq pq pq pq pq pq 
  33.  
  34.         p-Cq  
  35.                 Pass  all  comments  (except  those  that appear on  pcppq
  36.                 directive lines) through the preprocessor.  By  default,
  37.                 pcppq strips out C-style comments.  
  38.  
  39.         p-Pq[012]  
  40.                 Preprocess  the input without producing the line control
  41.                 information used by the next pass of the C compiler.   A
  42.                 numeric  argument  can be passed to -P: 0 specifies that
  43.                 no line control information control is generated, and is 
  44.                 equivalent to -P; 1 specifies that normal  line  control
  45.                 information  is  generated,  which is the default; and 2
  46.                 specifies that line control information is generated  in
  47.                 the form of preprocessor  p#lineq directives.  
  48.  
  49.         p-Tq  
  50.                 Translate trigraphs in the input file.  This behavior is 
  51.                 implied by the p-ansiq option.  
  52.  
  53.         p-Dq name  
  54.                 Define  pnameq  as  1  (one).    This  is the same as if a
  55.                 p-Dqnamep=1qpq option appeared on the  pcppq command line, or as 
  56.                 if a 
  57.  
  58.          
  59.                 p#defineq name p1qpq 
  60.  
  61.  
  62.  
  63.  
  64. Thu Jul 7 22:27:55 1994                                           Page 1
  65.  
  66.  
  67.  
  68.  
  69. CPP (1)                       30 May 1993                        CPP (1)
  70.  
  71.  
  72.  
  73.          
  74.                 line  appeared  in  the  source  file  that     pcppq   is
  75.                 processing.  
  76.  
  77.         p-Dqnamep=qdef  
  78.                 Define pnameq  as  if by a p#defineq directive.  This is the
  79.                 same as if a 
  80.  
  81.          
  82.                 p#defineq name pdefqpq 
  83.  
  84.          
  85.                 line  appeared  in  the  source  file  that     pcppq   is
  86.                 processing.  The p-Dq option has lower precedence than the 
  87.                 p-Uq  option;  that is, if the same name is used in both a
  88.                 p-Uq option and a p-Dq option, the name  will  be  undefined
  89.                 regardless of the order of the options.  
  90.  
  91.         p-Iqdirectory  
  92.                 Insert    pdirectoryq  into  the  search path for p#includeq
  93.                 files with names not beginning with q`p/q', `p\q´,pq or a drive 
  94.                 specifier.  pdirectoryq is inserted ahead of the  standard
  95.                 list of  ``include''  directories.  Thus, p#includeq files
  96.                 with names enclosed in double-quotes  (p"q)  are  searched
  97.                 for first in the directory of the file with the p#includeq 
  98.                 line,  then  in  directories  named with p-Iq options, and
  99.                 lastly, in directories from  the  standard  list.    For
  100.                 p#includeq  files  with  names  enclosed in angle-brackets
  101.                 q(p<>q),pqpq the directory of the file with the  p#includeq  line
  102.                 is not  searched.   See pUSAGEq below for exact details of
  103.                 this search order.  
  104.  
  105.         p-Sq[filename]  
  106.                 Specify an alternate configuration file.  If pfilenameq is 
  107.                 present, the specified  file  is  read  instead  of  the
  108.                 default  configuration  file; if pfilenameq is absent, the
  109.                 default configuration file is  simply  not  read.    See
  110.                 pUSAGEq below for further details.  
  111.  
  112.         p-Uqname  
  113.                 Remove  any  initial definition of pnameq,pqpq where pnameq is a
  114.                 symbol that is predefined by the preprocessor.  
  115.  
  116.         p-Vq  
  117.                 Print version information to pstderrq.pqpq 
  118.  
  119.         p-ansiq  
  120.                 Define the preprocessor token p__STDC__q to have value  1,
  121.                 and enable   trigraph  translation.    To  get  p__STDC__q
  122.                 without  trigraph  translation,  you  can  specify   the
  123.                 options p-ansiq p-Tq.pqpq 
  124.  
  125.         The  following  p-fq and p-Wq options can be negated by adding a pno-q
  126.         before the option name.  Some are on by default.  
  127.  
  128.  
  129.  
  130. Thu Jul 7 22:27:55 1994                                           Page 2
  131.  
  132.  
  133.  
  134.  
  135. CPP (1)                       30 May 1993                        CPP (1)
  136.  
  137.  
  138.  
  139.         p-fc++-commentsq  
  140.                 Support the C++ comment indicator q`p//q´.pqpq With this option 
  141.                 active, everything on the line after the p//q  is  treated
  142.                 as a comment.  Off by default.  
  143.  
  144.         p-Wbad-charsq  
  145.                 Issue  a  warning  if  a  character  that cannot legally
  146.                 appear in a C program appears  in  the  input.    On  by
  147.                 default.  
  148.  
  149.         p-Wnested-commentsq  
  150.                 Issue  a  warning  if a comment-start character sequence
  151.                 q(`p/*q´,pqpq and q`p//q´pqpq if p-fc++-commentsq is active) appears  in
  152.                 a comment.  Off by default.  
  153.  
  154.         p-Wbad-concat-tokensq  
  155.                 Issue  a  warning if the token concatenation operator ##
  156.                 produces an illegal C token.  On by default.  
  157.  
  158.         Options beginning with p-Xq are for specialized interactions  with
  159.         particular  programs,  and  should    not  generally  be invoked
  160.         directly by the user.  The following such options are  currently
  161.         recognized: 
  162.  
  163.         p-Xfluffq  
  164.                 This   option  is  used  by  the  pfluffq(1)pqpq  source  code
  165.                 checker.  It causes the preprocessor token p__FLUFF__q  to
  166.                 be defined,  and  enables  certain related pragmas.  See
  167.                 the pfluffq(1)pqpq documentation for further information.  
  168.  
  169. pUSAGEq pq pq pq pq pq pq pq pq 
  170.         If you are familiar with C, you should already  know  about  the
  171.         basic   workings  of  pcppq.pqpq  We  will  not  go  into  a  detailed
  172.         description here, since any good book  on  C  could  do  better;
  173.         instead,   we   will   describe   details   particular  to  this
  174.         implementation.  
  175.  
  176.         ppDirectory Search Orderqq pq pq pq pq pq pq pq pq 
  177.  
  178.  
  179.         A file specified in an p#includeq directive will be  searched  for
  180.         in the following directories, in order: 
  181.  
  182.         1.  
  183.                 The  directory  of  the file that contains the  p#includeq
  184.